home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / fortune.zip / FORTUNE.DOC < prev    next >
Text File  |  1989-08-16  |  21KB  |  497 lines
  1.           
  2.           
  3.           
  4.           
  5.           
  6.           
  7.           
  8.           
  9.           
  10.           
  11.           
  12.           
  13.           
  14.           
  15.           
  16.                     ┌────────────────────────────────┐
  17.                     │                                │
  18.                     │   Fortune Cookie version 2.0   │
  19.                     │                                │
  20.                     │               By               │
  21.                     │                                │
  22.                     │        Thomas J. Clancy        │
  23.                     │                                │
  24.                     │       Copyright (c) 1989       │
  25.                     │          TC Software           │
  26.                     │         Thiel College          │
  27.                     │      Greenville, PA 16125      │
  28.                     │                                │
  29.                     └────────────────────────────────┘
  30.  
  31.           
  32.                              Table of Contents
  33.           
  34.           
  35.           Subject                                            Page#
  36.           
  37.           INTRODUCTION.......................................    1
  38.           
  39.           INSTALLING FORTUNE COOKIE..........................    1
  40.           
  41.                Required files................................    1
  42.                Hardware and Software requirements............    2
  43.           
  44.           RUNNING FORTUNE COOKIE.............................    2
  45.           
  46.                Printing Cookies..............................    2
  47.                Adding Cookies................................    3
  48.                Displaying Cookies............................    3
  49.                Erasing, Unerasing, and Compressing...........    4
  50.                A Look Inside the Cookie Jar..................    5
  51.                Smashing the Cookie Jar.......................    6
  52.                Using the Flags...............................    6
  53.           
  54.           USING FORTCNVT.....................................    7
  55.           
  56.           TECHNICAL INFORMATION..............................    7
  57.           
  58.           A SHAREWARE NOTE...................................    8
  59.           
  60.           QUESTIONS AND COMMENTS.............................    8
  61.           
  62.  
  63.           
  64.           INTRODUCTION
  65.           
  66.                 Welcome to the world of Fortune Cookie.  This is a
  67.           simple program for displaying and editing quotations or
  68.           personal sayings or what have you.  This is perfect for
  69.           including in your AUTOEXEC file for displaying a random
  70.           fortune whenever you boot your system.
  71.           
  72.                I've always enjoyed collecting famous quotations and
  73.           especially enjoyed the fortune cookie program on the DEC
  74.           MINI's like the PDP-11, so I decided to write my own.  No,
  75.           not in the tradition of C, but in Turbo Pascal 5.5.
  76.           
  77.                Using Fortune Cookie is very simple which I'll explain
  78.           in a moment.  Your probably wondering what you can do with
  79.           Fortune.  If you ran fortune before reading this manual you
  80.           probably noticed the numerous options that I've included in
  81.           version 2.0.
  82.           
  83.                You're also probably wondering where and when I released
  84.           1.0.  I've only posted version 1 on local BBS's in my area
  85.           for BETA testing.  Now that I've fixed most of the bugs (I'd
  86.           like to think all the bugs, but that's very wishful thinking)
  87.           I'm hoping to distribute it in a wider area.
  88.           
  89.                With Fortune Cookie, you can add quotes (or cookies) to
  90.           the cookie file, you can display a certain cookie, you can
  91.           display a random cookie, you can send you're cookie file to
  92.           the printer, you can kill the cookie file (smash the cookie
  93.           jar), you can erase and unerase a cookie, and you can
  94.           compress the erased cookies (erasing just marks them for
  95.           deletion).
  96.           
  97.           
  98.           INSTALLING FORTUNE COOKIE
  99.           
  100.                Before installing Fortune Cookie you should check to see
  101.           that you have the following files:
  102.           
  103.                FORTUNE.EXE   - The executable fortune cookie program.
  104.                FORTUNE.DOC   - This manual (of course).
  105.                FORTCNVT.EXE  - Fortune cookie 1.0 to 2.0 file converter
  106.                COOKIE.DOC    - The Cookie Jar (file of fortune cookies)
  107.                README.BAT    - Batch file that loads manual into file
  108.                                viewer.
  109.                VIEW.EXE      - The file viewer program.
  110.           
  111.           If you're missing one of these file please notify the sysop
  112.           of the board or the person from whom you copied it, or let me
  113.           know so that I can send you a fresh copy.  Actually, the file
  114.           viewer is just a luxury so it's not essential for running
  115.           Fortune Cookie.  I just provide the file viewer with most of
  116.           my software.
  117.           
  118.                This program is small and should run in 64K of memory.
  119.           I have 640K (as do most of us) so I haven't been able to test
  120.           it on a machine with less memory but I think it'll work
  121.           comfortably on any PC Compatible these days.  It will run
  122.  
  123.                                                            Page (1)
  124.  
  125.           under DOS 2.0 or higher, maybe even 1.0, but I haven't tested
  126.           it below DOS 2.  Although Fortune Cookie will run from a
  127.           floppy disk, a hard disk is preferable and much faster.
  128.           
  129.                If you are using a hard disk, and I'll assume you are,
  130.           the easiest way to install Fortune would be to create a
  131.           subdirectory, in the root directory, called FORTUNE and
  132.           copy all the files from the distribution disk to that directory.
  133.           Then add the following lines to your AUTOEXEC.BAT file:
  134.           
  135.                cd \FORTUNE
  136.                FORTUNE /r
  137.                cd \
  138.           
  139.           I'll explain what the /r after FORTUNE is in a moment.
  140.           
  141.                 Since Fortune Cookie doesn't search the path for the
  142.           cookie jar, it is essential that you run it in the same
  143.           subdirectory where the cookie jar is stored.
  144.           
  145.                If you don't have a hard disk just place all the files
  146.           in the root directory of a favorite floppy.  All the
  147.           instruction will apply to you as well since Fortune Cookie
  148.           does not rely on a hard disk.
  149.           
  150.           
  151.           RUNNING FORTUNE COOKIE
  152.           
  153.                                 Printing Cookies:
  154.           
  155.                 Your probably interested in seeing what sort of cookies
  156.           you have in your jar.  If you have a printer attached to your
  157.           computer you have two ways of printing your fortunes.  One
  158.           way is to do a straight dump to the printer by typing:
  159.           
  160.                Fortune /P
  161.           
  162.           or you can send a numbered listing to the printer by typing:
  163.           
  164.                Fortune /#
  165.           
  166.           If you haven't got a printer you can still see all the
  167.           fortunes by typing:
  168.           
  169.                Fortune /D
  170.           
  171.           which displays the fortunes on the screen one after the
  172.           other.  Press the HOLD key (Tandy 1000) or Scroll Lock key
  173.           (the others) to pause the display.
  174.           
  175.                Once you've gotten a hard copy, or memorized the screen
  176.           listing, you can add new ones or delete any current ones.
  177.           Because this is shareware you may have a cookie jar that has
  178.           been altered by many hands.  If you are using this program,
  179.           and are planning to pass it on, I would appreciate it if you
  180.           would keep the original file in tact for others to see.  You
  181.           can add new ones, but I would appreciate it if you would not
  182.           delete the originals when passing it on to